home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / multnode.zip / README.1ST < prev   
Text File  |  1991-05-19  |  15KB  |  315 lines

  1.  
  2.  
  3.           ****** MultiNode Batch File Setup for 3 Nodes ******
  4.              *** 2 "Live" nodes and 1 "Local Only" node ***
  5.  
  6.                       Copyright 1991 by Mark Lewis
  7.                                   and
  8.                      the Spirit of Support -=FBBS=-
  9.                             FIDONet 1:275/20
  10.                              (804) 498-0065
  11.  
  12.                   All Right Reserved in Time and Space
  13.  
  14.  
  15.  
  16.  
  17. first things first <sigh>......
  18.  
  19.                          **** LEGALITIES ****
  20.  
  21. i/we at the Spirit of Support -=FBBS=- do not guarrantee that the batch
  22. files and sample screen dumps contained in this .ZIP will work _perfectly_
  23. on your system. the .BAT files and samples in this archive are provided
  24. as is without warranty of any kind, either expressed or implied. the only
  25. thing guarranteed about the files included in this archive is that they
  26. will take up diskspace. if you find that they do not serve your purposes,
  27. delete them. it's that easy. if they break themselves on your system, you
  28. own both parts and cannot hold the Spirit of Support -=FBBS=-, the SysOp(s),
  29. or myself liable for any damages to you or your system. this includes
  30. downtime and is not limited to any monies lost due to downtime. also, these 
  31. .BAT files and the associated utilities mentioned *CAN NOT* and will not 
  32. cause *ANY* damage to your hardware or equipment!
  33.  
  34.  
  35.  
  36.                        ***** REGISTRATION *****
  37.  
  38. now, don't take this part the wrong way<grin>.... if you find that these .BAT
  39. files and/or samples help you in your quest to become a multinode system, all
  40. we ask is that you NetMail Mark Lewis or Jim Putt at 1:275/20.0 and let them
  41. know that you are using the basics outlined or the files included in this
  42. archive file. this way they will know that others are interested in what they
  43. can provide and will encourage them to continue the development of this and
  44. other items/programs that may help you in the development of you system for
  45. the use of your members. after all, what's the cost of a phone call compared
  46. to what you can make and/or provide for the members of your BBS?
  47.  
  48.  
  49. now that that is over with... on to the real stuff....
  50.  
  51.  
  52.                         *** the REAL stuff ***
  53.  
  54. you will, in most cases, need to modify these files. before doing so,
  55. make sure you are working on a *copy* not the originals. i cannot provide
  56. help on code that has been modified without knowing what modifications
  57. were done and how they are being implemented. the first modification most
  58. likely needed will be the drive and systems directories for RA and FD.
  59. the included BBS.BAT runs everything from our C: drive whereas our test
  60. site unit runs everything from D: drive. if you stick with the "basics"
  61. and use <DRIVE:>\RA and <DRIVE:>\FD as your system directories, you will
  62. find modification much easier.
  63.  
  64. you will need a few utilities for these .BAT files to work correctly...
  65. a copy of DTR.COM and AT.COM will prove invaluable to help in the control
  66. of your modem at 'critical' times.... like making sure the phone is
  67. offhook when tossing mail or updating the bulletins and such. another
  68. utility that makes 'life easier' is DVCOMAND. i found it in DVCO12.ZIP
  69. a couple of months ago. if you can't find a copy, let me know and i'll
  70. make it available as soon as possible <<grin>>. in this setup, DVCOMAND
  71. is used to delay operation of the .BAT file at key points.... it can also
  72. be used to open other windows in the background for 'event processing'
  73. which opens a lot of ideas for me<grin>.
  74.  
  75. Oh Yeah!! you'd better also have a copy of IMAIL if you expect the 
  76. tossing/scanning of echomail to work without any modification to the
  77. BBS.BAT file<<grin>>. you should also have IMAIL set up and operating in
  78. a single node environment first. i haven't tried any other mail processing
  79. utilities like GEcho or TosScan but, you should be able to modify the
  80. BBS.BAT where necessary to handle any other mail processing utilities you
  81. might want to use.
  82.  
  83. i highly recommend that you print out a copy of BBS.BAT and read through
  84. it so you can understand what is happening where and when. it's only about
  85. 9 (nine) pages and there are some loopbacks that take place and are
  86. confusing at times if you don't have a printout to follow<<grin>>... one,
  87. in particular, that was fun to do, was the ability for node 2 to toss mail
  88. if a packet came in on node 1 while node 2 was online with a user and this
  89. has been expanded so that node 3 has this ability also. note that the
  90. inbound/outbound mail tossing/scanning takes place As Soon As Possible...
  91. in other words, the inbound mail packets will sit in your inbound
  92. directory until all the nodes are free of callers... then, and only then,
  93. will the LAST node out toss the inbound mail. in the case of outbound
  94. mail, the BBS.BAT looks for the ECHOMAIL.BBS and NETMAIL.BBS files in your
  95. BBS's messagebase directory... if they, either one or both exist, then
  96. your mail processor's scanning function should be run. in the case of both
  97. inbound and outbound mail waiting for processing, the inbound mail packet
  98. is tossed before the outbound packet is created.
  99.  
  100. ok.... now on to the rest of the setup....
  101.  
  102. first, name or rename the individual node directories to N1 or N2, etc...
  103. ie: D:\RA\N1 for RA node 1 and D:\FD\N1 for FD node 1... put the
  104. CONFIG.RA file from your main RA directory into each node's
  105. <DRIVE:>\RA\N? directory. this is necessary if you want to have different
  106. system prompts and echomail addresses for each node. you can share the
  107. CONFIG.RA between nodes if you like. in the case of sharing the CONFIG.RA,
  108. you won't need to put a copy in each node (N?) directory. in our setup,
  109. we have a different POINT number for each of our nodes. and this, plus a
  110. few node specific prompts, causes us to go with the seperate copies of
  111. CONFIG.RA.
  112.  
  113. the following are the things that need to be changed in RACONFIG for each
  114. node, in the case of seperate CONFIG.RA's, you will have to be in the
  115. specific directory for the node you are modifying before you run RACONFIG. also, note that any changes to the message areas, protocals, or files areas are "global" for the nodes as these files are shared in this set up... with this in mind, you could have different file areas and message areas for each node, but that kind of setup is not what this package was created for, although it is very easily accomplished once you stop and think about it<<GRIN>>...
  116.  
  117.                  1) your address ie: 1:275/20.0 for your node 1 and                            1:275/20.1 for node 2...
  118.                     if you want to run your other node(s) as POINTS off
  119.                     of your main node. otherwise you can get another node
  120.                     number and use that... ie: 1:306/23 and 1:306/28...
  121.                      (hope you don't mind the plug, Josh<<grin>>)
  122.                  2) the modem port and the baud rate.
  123.                     note that in this BBS.BAT file, we use the command                         line over-rides to specify the port, baud, and speed                     in use for each node.
  124.                  3) the logfile names.....i made a directory and put *ALL*
  125.                     logfiles there.. ie: D:\LOGS <grin>.. each node, FD 
  126.                     included, must have it's own logfile.... 
  127.                     ie: node 1 - FDN1.LOG and RAN1.LOG..
  128.                     makes it easy, hunh?? <<grin>>
  129.                  4) the RA system directory stays the same 'cause that's
  130.                     where all the other configuration files are... RA                          looks in the current directory for it's needed                             configuration files and if it cannot find them, then                       it looks at the environment variable(s) set in the                         N?.BAT startup file.
  131.  
  132. now, as we/i have only used FrontDoor, this is the only one i can comment
  133. on.... in FD's SETUP do the same as above except that the FD system
  134. directory becomes the nodes directory.... ie: before.. FD system dir was
  135. D:\FD.... for nodes 1 & 2 it now becomes D:\FD\N1 and D:\FD\N2
  136. respectively. all the config files for FD are put in each FD nodes
  137. directory.. you may be able to share the .EXE's and .OVR's but this
  138. method works, albeit a li'l space consuming but it works.... the inbound
  139. (file), outbound (packet), nodelist, and netmail directories are all
  140. shared... each node has it's own ROUTE.FD and node 2 doesn't send or poll
  141. for *any*thing but can receive mail or files and can also handle FREQs...
  142. node 1 is your 'master' node, if you will.... it does everything including
  143. all system maintainence. you may also have to tell each node to use the
  144. address of the other as an AKA if you run into problems with the second
  145. node not receiving mail destined for node 1 and visa versa...
  146.  
  147. now, put the N1, N2, and N3 .BAT files in your path and the BBS.BAT in
  148. your main RA directory. make sure your DV, FD, RA, and IMAIL directories
  149. are in your path. in DV, create PIF files for each node starting them
  150. with the .BAT file for that node.... below is my DV PIF file for my
  151. node 1....note that i do NOT specify a directory.... let the .BAT file
  152. control all movement<grin>...
  153.  
  154. ============================ snip ======================================
  155.  
  156.                                Change a Program
  157.  
  158.  Program Name............: RA Node 1
  159.  
  160.  Keys to Use on Open Menu: N1                    Memory Size (in K): 1
  161.  
  162.  Program...: n1.bat
  163.  
  164.  Parameters:
  165.  
  166.  Directory.:
  167.  
  168.  Options:
  169.                   Writes text directly to screen.......: [N]
  170.                   Displays graphics information........: [N]
  171.                   Virtualize text/graphics (Y,N,T).....: [N]
  172.                   Uses serial ports (Y,N,1,2)..........: [Y]
  173.                   Requires floppy diskette.............: [N]
  174.  
  175.   Press F1 for advanced options
  176.  
  177.  
  178.                       Change a Program Advanced Options
  179.  
  180.  System Memory (in K).......: 0 Maximum Program Memory Size (in K)..: 400
  181.  
  182.  Script Buffer Size.......:   0 Maximum Expanded Memory Size (in K):  256
  183.  
  184.  Text Pages: 1  Graphics Pages: 0   Initial Mode:    Interrupts: 00 to FF
  185.  
  186.  Window Position:
  187.     Maximum Height:  25     Starting Height:   1     Starting Row...:  24
  188.     Maximum Width.:  80     Starting Width.:  80     Starting Column:   0
  189.  
  190.                                 Shared Program
  191.  Pathname..:
  192.  Data......:
  193.  
  194.  Close on exit (Y,N,blank)......: [N] Uses its own colors...........: [Y]
  195.  Allow Close Window command.....: [Y] Runs in background Y,N,blank).: [Y]
  196.  Uses math coprocessor..........: [N] Keyboard conflict 0-F)........: [0]
  197.  Share CPU when foreground......: [Y] Share EGA when forgrnd/zoomed.: [Y]
  198.  Can be swapped out (Y,N,blank).: [N] Protection level (0-3)........: [0]
  199.  
  200. ================================ snip ===================================
  201.  
  202. here is a screen dump of my RA node 1 directory...
  203.  
  204. DV BBS | D:\RA\N1 >dir
  205.  
  206.  Volume in drive D has no label
  207.  Directory of  D:\RA\N1
  208.  
  209. .            <DIR>    3-21-91  5:02p
  210. ..           <DIR>    3-21-91  5:02p
  211. RABIMCFG 1        739 3-21-91  6:57p  */part of RABIM BiModem interface
  212. RABIMPTH 1         63 3-21-91  6:57p  */  "  "   "      "         "
  213. TIMELOG  BBS       71 4-10-91  2:24a  */created by each node
  214. FX-CHAT  CFG       67 3-21-91  6:13p   
  215. POPDOOR  CFG      818 3-21-91 10:25p
  216. QUICKED  CFG      532 3-21-91  8:44p  */Quicked config different for nodes
  217. RAMAIL   CFG      160 4-10-91  2:13a
  218. RA-BIM   CTL      150 3-21-91  6:55p  */part of RABIM BiModem interface
  219. USA      CTL     2576 1-14-91  4:01p
  220. POPDOOR  DAT     8181 4-11-91  2:21a
  221. POPUSER  DAT      191 4-11-91  2:21a
  222. QUICKED  HLP     2784 1-25-90  1:10a  */help file for Quicked, if used
  223. CONFIG   RA      3186 4-10-91  1:38a  */config file for this node
  224. DORINFO1 DEF      105 4-10-91  2:24a
  225.        17 File(s)   5957632 bytes free
  226.  
  227. DV BBS | D:\RA\N1 >
  228.  
  229. as you can see, you also need the config and control files for some of
  230. your utilities and doors in each nodes directory.... note that the main
  231. changes in these files are the same as for the RA config file.... port
  232. assignment (in some cases) and directory... experimentation is the only
  233. thing here... also note that any doors you run might need the
  234. DORINFO1.DEF and the EXITINFO.BBS files copied into their working
  235. directory... here is another prime example of using the environmental
  236. variables..... here is a sample from my ACFiles .BAT file that i have up
  237. for testing. note that any single node doors you run will need to use
  238. semaphore files to lockout any other node that may try to access it while
  239. it's in use.
  240.  
  241. ================================ snip ===================================
  242.  
  243. d:
  244. cd\ra\acfiles
  245. if exist imup.txt goto oops!
  246. rem > imup.txt
  247. copy d:\ra\%node%\dorinfo1.def
  248. copy d:\ra\%node%\exitinfo.bbs
  249. if %port% == 0 goto oops!l
  250. acfiles
  251. copy exitinfo.bbs d:\ra\%node%
  252. del imup.txt
  253. d:
  254. cd\ra\%node%
  255. goto end
  256. :oops!l
  257. echo OOPS!
  258. echo I'm sorry. someone else is using this door right
  259. echo now. Please try back in a few minutes.
  260. echo Thank you.
  261. dvcomand wait 30
  262. goto end
  263. :oops!
  264. echo OOPS! > com%port%:
  265. echo I'm sorry. someone else is using this door right > com%port%:
  266. echo now. Please try back in a few minutes. > com%port%:
  267. echo Thank you > com%port%:
  268. dvcomand wait 30
  269. :end
  270.  
  271. ================================= snip ==================================
  272.  
  273. as you can tell above, the most used EV's (environment variables) are
  274. going to be %node% and %port%..... these are set in N?.BAT and in
  275. BBS.BAT respectively.....and also, this .BAT file makes use of a semaphore
  276. lockout file for a single node door.... multinode doors are much
  277. simpler<grin> and should include instructions for running them in a
  278. multinode situation.
  279.  
  280. this should give you a good headstart into a multinode setup.... you are
  281. free  to modify the .BAT files as needed for *your* system. if you pass
  282. this .ZIP file on to others, it must be distributed in it's original
  283. ummodified form. you may, if you desire, convert this .ZIP to any other
  284. archive format... ie: .LZH, .ZOO, etc...  if you find a unique problem or
  285. a fix for one that i haven't spotted and taken care of, i am definately
  286. interested in knowing about it.... in fact, you could send your mods/ideas
  287. to me if you like<grin>... and, i'm always interested in new ways to do
  288. things<<grin>> so if you spot a place where these .BAT files could use a
  289. little bit of streamlining, let me know.
  290.  
  291. happy multinodeing,
  292.  
  293.         .\\ark Lewis - CoSysOp - the Spirit of Support -=FBBS=-
  294.                           FIDONet 1:275/20.0
  295.                              804-498-0065
  296.  
  297. the above documentation and included .BAT files brought to you by ... 
  298.  
  299. .\\ark's Advanced Batch File Programming Techniques <grin>
  300.  
  301.  
  302.                       ***** Copyright Notices *****
  303.  
  304. FrontDoor     Copyright 1989, 1990 by Joaquim H. Homrighausen 
  305.                          and Peter Stewart
  306. Remote Access Copyright 1989-91 by Andrew Milner
  307.                         and Continental Software
  308. IMail         Copyright 1990, 1991 by Fabiano Fabris
  309.                          for Intuition Software
  310. DTR.COM       Copyright 1985 by Donavon Kuhn and Jon Niedfeldt
  311. AT.COM        Copyright 1985 by Donavon Kuhn and Jon Niedfeldt
  312. DVCOMAND      Copyright 1989 by William E. Allen
  313. ACFiles       Copyright 1991 by Ray Cole
  314.  
  315.